Skip to content

docs: add a navbar to the webpage#46

Merged
snipsnipsnip merged 5 commits intoexteditor:mainfrom
snipsnipsnip:webpage-navbar
Oct 21, 2025
Merged

docs: add a navbar to the webpage#46
snipsnipsnip merged 5 commits intoexteditor:mainfrom
snipsnipsnip:webpage-navbar

Conversation

@snipsnipsnip
Copy link
Copy Markdown
Member

#5

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Oct 21, 2025

📝 Walkthrough

Summary by CodeRabbit

  • New Features

    • Added navigation bar with links to GitHub, FAQ, and translation resources.
    • Implemented footer injection system for consistent page styling.
  • Documentation

    • Enhanced documentation with improved cross-references and internal linking in design and building guides.
    • Updated FAQ descriptions clarifying project status and maintenance information.
  • Style

    • Updated favicon tag formatting.
  • Chores

    • Updated package metadata: homepage URL, added bug tracking link, and funding information.

Walkthrough

The PR updates website assets, documentation, and project metadata. Changes include simplified asset paths, enhanced navigation UI, refactored site utilities with helper functions, cross-referenced documentation links, updated FAQ content, and revised package.json metadata including homepage, bugs, and funding URLs.

Changes

Cohort / File(s) Change Summary
Website assets and configuration
.github/site/coverpage.md, .github/site/index.html, .github/site/index.mjs
Simplified asset path reference (removed leading ./); enhanced HTML with navigation bar containing GitHub, FAQ, and Translation links; refactored URL construction into centralized helpers (urlFor, redirectTo, addFooter); added formatUpdated Docsify configuration option for standardized date formatting
Documentation
doc/building.md, doc/design.md, doc/faq.md
Updated build and reproducibility documentation notes; converted plain file paths to cross-referenced Markdown links with anchor definitions for improved navigability; updated terminology and wording for clarity regarding project maturity and extension descriptions
Project metadata
package.json
Changed homepage URL from GitHub repository to hosted documentation site; added bugs field pointing to GitHub issues; added funding field pointing to Thunderbird donation page

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Heterogeneous changes across multiple file categories require separate reasoning for each cohort. Website refactoring introduces helper utilities and modifies plugin hooks. Documentation changes are primarily link conversions and wording updates. Package metadata changes are straightforward but represent intentional project positioning shifts.

Possibly related PRs

Poem

🐰 With paths now trimmed and links all bright,
Our docs hop forth with anchors right,
A nav bar gleams in GitHub's sight,
While metadata joins the flight—
This little PR makes all things light! ✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Description Check ⚠️ Warning The PR description consists solely of "#5" with no substantive content. Compared to the required template, the description is missing all key sections: no explanation of current behavior (with issue reference details), no description of new behavior, no manual testing steps, and no additional context. The template expects structured information about the issue being addressed, the changes made, how to verify them, and any relevant notes. A single issue reference is insufficient and does not meet the repository's documentation standards for pull requests. The author should complete the pull request description by filling in the template sections: specify what issue #5 addresses under "What is the current behavior?", explain the new behavior being introduced, provide clear testing steps to verify the navbar addition and other changes, and add any relevant implementation notes. This will help reviewers understand the full context and impact of the changes.
✅ Passed checks (2 passed)
Check name Status Explanation
Title Check ✅ Passed The title "docs: add a navbar to the webpage" accurately refers to a real change in the pull request—the index.html file does introduce a new navigation bar containing links to GitHub, FAQ, and Translation. However, the actual changeset is much broader, encompassing website refactoring in index.mjs (new helper utilities, footer injection, Docsify configuration), multiple documentation file updates (building.md, design.md, faq.md with restructured cross-references), an image path fix in coverpage.md, and package.json metadata updates. The title only captures one visible feature among numerous substantial changes and doesn't represent the comprehensive scope of the work, making it a partial representation of the changeset rather than a summary of the primary or most significant changes.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link
Copy Markdown

codecov bot commented Oct 21, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 46.97%. Comparing base (a17f5ce) to head (aced189).
⚠️ Report is 6 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files
Components Coverage Δ
app 32.47% <ø> (ø)
ghosttext 49.18% <ø> (ø)
infra 44.00% <ø> (ø)

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
.github/site/index.mjs (1)

16-21: Consider simplifying the script tag escape sequence.

The ${'</'}script> pattern works but is unusual. Consider using a comment or a more conventional escape method.

Apply this diff for a clearer approach:

-const redirectTo = (url) => `Redirecting to ${url}...\n\n<script>\nlocation.href = "${url}"${'</'}script>`;
+const redirectTo = (url) => `Redirecting to ${url}...\n\n<script>\nlocation.href = "${url}";<\/script>`;
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between a17f5ce and aced189.

📒 Files selected for processing (7)
  • .github/site/coverpage.md (1 hunks)
  • .github/site/index.html (1 hunks)
  • .github/site/index.mjs (3 hunks)
  • doc/building.md (2 hunks)
  • doc/design.md (6 hunks)
  • doc/faq.md (2 hunks)
  • package.json (1 hunks)
🧰 Additional context used
🪛 LanguageTool
doc/design.md

[grammar] ~304-~304: Ensure spelling is correct
Context: ...rtup_*.ts][startupdir] are used at the toplevel modules, namely [background.ts`][backg...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🔇 Additional comments (18)
doc/design.md (4)

177-178: LGTM!

Simple and clear addition to the tooling section.


193-195: Cross-references look good.

The reference-style links make the documentation more maintainable and enable cross-referencing. Anchors are properly defined.


199-207: Subdirectory references are clear.

Using inline links for directory references is pragmatic and readable. No issues here.


363-366: Anchor definitions are complete and well-organized.

All four anchors are properly defined and used consistently throughout the document. The reference-style linking enables better documentation maintainability.

.github/site/coverpage.md (1)

2-2: LGTM! Asset path normalized.

The removal of the leading ./ simplifies the path reference and aligns with the favicon path in index.html.

.github/site/index.html (2)

10-10: LGTM! Favicon tag format updated.

The non-self-closing format is more standard for HTML5.


14-18: Nav element styling is provided by Docsify—no additional CSS required.

The <nav> element is styled by the external Docsify Vue theme (docsify@4.13.1/lib/themes/vue.min.css), which handles appearance, positioning, and responsive behavior automatically. No custom CSS needs to be added to the repository.

Likely an incorrect or invalid review comment.

doc/faq.md (3)

90-90: LGTM! More descriptive explanation.

The updated description provides clearer context about External Editor Revived.


95-95: LGTM! Status updated to beta.

The maturity status has been updated from "alpha" to "beta", reflecting the project's progress.


109-109: Fragment identifier verified—link is valid.

The #yarn-assets fragment exists on the target page, anchored to the "Yarn Assets" heading in the README. The link will function correctly.

doc/building.md (2)

56-56: LGTM! CI usage clarified.

The updated description explicitly mentions CI usage, improving documentation clarity.


114-114: LGTM! Reproducibility note enhanced.

The updated note provides a more nuanced explanation of build reproducibility differences between Firefox and Thunderbird add-ons, with clear context about potential future improvements.

package.json (1)

15-17: LGTM! Package metadata enhanced.

The homepage has been updated to point to the new GitHub Pages site, and additional public metadata fields (bugs and funding) have been added. These changes improve package discoverability and provide clear paths for users to report issues and support the project.

.github/site/index.mjs (5)

4-4: LGTM! TypeScript checking enabled.

Adding @ts-check enables type checking in this JavaScript file, improving code quality.


23-37: LGTM! Dynamic footer implementation.

The addFooter function provides a clean, centralized way to add footers with back-to-top links and last update information.


45-45: LGTM! Date format configuration added.

The formatUpdated option standardizes the date format across the documentation.


54-65: LGTM! Routes refactored to use helper functions.

The routes now use the centralized urlFor and redirectTo helpers, improving maintainability.


87-90: LGTM! Plugin updated to use dynamic footer.

The plugin now uses the addFooter helper for consistent footer injection.

@snipsnipsnip snipsnipsnip added this pull request to the merge queue Oct 21, 2025
Merged via the queue into exteditor:main with commit 4ea6e36 Oct 21, 2025
8 checks passed
@snipsnipsnip snipsnipsnip deleted the webpage-navbar branch October 21, 2025 08:51
@github-project-automation github-project-automation bot moved this from 📥️Inbox to 🪺Experimental in Ghostbird Issues Oct 21, 2025
@snipsnipsnip snipsnipsnip moved this from 🪺Experimental to ✅Closed in Ghostbird Issues Oct 21, 2025
@snipsnipsnip snipsnipsnip linked an issue Oct 29, 2025 that may be closed by this pull request
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

[Task] Website with some screenshots

1 participant